home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 1
/
Cream of the Crop 1.iso
/
BBS
/
FPOINTS3.ARJ
/
FPOINTS.DOC
< prev
next >
Wrap
Text File
|
1992-07-23
|
14KB
|
333 lines
FPOINTS Version 3.0
===================
Copyright (c) 1992
By Dragon Software
23 Jul 92
ALL RIGHTS RESERVED
FPOINTS Version 3.0 by Dragon Software Page 1
==============================================================================
DISCLAIMER:
===========
This program is provided "As Is". All responsibility and risk in running
this program is taken on completely by the person using this program. This
program comes without any warranty, expressed or implied. If you do not
agree with the above, please don't use this program.
FPOINTS INTRODUCTION:
=====================
This program will automatically update the "Point Value Field" of the *.DIR
file and "Point Value Field" of the USER.LST file using Point Values specified
by you in a config file for all files uploaded to T.A.G. v2.6c1. File Points
can be assigned by one of three methods: A GLOBAL value for all files uploaded;
by the file upload PATH; or by the file SIZE (in kbytes). A different Point
Value can also be specified for both the File and the User. Information
is displayed on the local and remote end letting the SysOp and User know what
is going on. You may use FPCONFIG.EXE to create the configuration file
(FPOINTS.CFG) or any Text Editor that saves the file in ASCII text format. The
FPOINTS.CFG file must reside in the same directory as FPOINTS.EXE.
USAGE:
======
FPOINTS %2 %3 %4 %5 %6
FPOINTS COMMAND LINE PARAMETERS:
================================
The information for these parameters is passed to the "POSTUL.BAT" file by
T.A.G. itself. Here is a brief description of what they stand for:
%2: Comport 1-4.
%3: User ID#.
%4: Upload path where file went.
%5: Filename of uploaded file.
%6: Filename of *.DIR file.
EXAMPLE "POSTUL.BAT" FILE:
==========================
ECHO OFF <---- Turn echoing of commands off (Optional).
CLS <---- Clear the screen (Optional).
FPOINTS %2 %3 %4 %5 %6 <---- Program to run and parameters (Mandatory).
The "POSTUL.BAT" file must be placed in the "MAIN BBS DIR" (normally C:\BBS).
FPOINTS searches for the uploaded file and will not credit the user if that
file is not found. Because of the deletion feature of TAGSCAN, FPOINTS should
be called after TAGSCAN if your POSTUL.BAT file calls TAGSCAN. FPOINTS can be
run from the "MAIN BBS DIR" or it's own directory (make sure the "POSTUL.BAT
file reflects this).
TAGSCAN is the post upload Virus Scan utility, copywrited by Tony Mann and
Bill VanWeezenbeeck.
FPOINTS Version 3.0 by Dragon Software Page 2
==============================================================================
EXAMPLE "FPOINTS.CFG" FILE FOR "GLOBAL" FILE POINT ASSIGNMENT:
==============================================================
C:\BBS\DFILES <---- Your "Main Data File Path".
C:\MULTI <---- Your "Multi-user Data File Path".
C:\BBS\FPOINTS.LOG <---- Path and File Name for the LOG.
1F/5U <---- File Points (0-255)/User Points (0-65535) to
assign to all uploaded Files/Users. Please
insure that the "F", "/" and "U" are placed as
shown.
Note: Only four lines are required for this setup!
An error will result if any of these lines are incorrect. Although spaces are
checked for by FPOINTS, it is recommended that none be placed before, within
or after any line in the FPOINTS.CFG file.
EXAMPLE "FPOINTS.CFG" FILE FOR "PATH" FILE POINT ASSIGNMENT:
============================================================
C:\BBS\DFILES <---- Your "Main Data File Path".
C:\MULTI <---- Your "Multi-user Data File Path".
C:\BBS\FPOINTS.LOG <---- Path and File Name for the LOG.
1F/5U <---- File Points (0-255)F/User Points (0-65535)U
to assign to all uploaded files that are not
found within the Paths specified within the
following lines. Please insure that the "F",
"/" and "U" are placed as shown.
PATH <---- Statement required if you are assigning File
Points by Upload Path.
C:\BBS\FILES\SYSOP\/5F/10U <---- Complete path (with trailing Back-Slash)/File
Points (0-255)F/User Points (0-65535)U.
Please insure that the "F", "/"'s and "U" are
placed as shown.
C:\BBS\FILES\LEE\/0F/20U <---- Complete path (with trailing Back-Slash)/File
Points (0-255)F/User Points (0-65535)U.
Please insure that the "F", "/"'s and "U" are
placed as shown.
Note: The above example would only be seven lines long in the actual
FPOINTS.CFG file. There is no limit to the number of "Upload
Paths" that may be specified.
An error will result if any of the first five lines are incorrect. Although
spaces are checked for by FPOINTS, it is recommended that none be placed
before, within or after any line in the FPOINTS.CFG file. In the above
example, all files uploaded to "C:\BBS\FILES\SYSOP\" would be credited with "5"
File Points and the User with "10" File Points. If a File were to be uploaded
to "C:\BBS\FILES\TEMP\" (Which is not defined above), the File would be
credited with "1" File Point and the User with "5" File Points (the default on
Line 2). Any files uploaded to "C:\BBS\FILES\LEE\" would be given no credit,
but the User would receive "20" File Points. The main thing you should know is
this: If you don't setup the Upload Paths or the File/User Point Values
correctly, the File Points on Line 4 will be used an no errors will result!
"ALLPNT" and "DIRPNT" can be used to convert your existing File Base.
FPOINTS Version 3.0 by Dragon Software Page 3
==============================================================================
EXAMPLE "FPOINTS.CFG" FILE FOR "SIZE (KBYTES)" FILE POINT ASSIGNMENT:
=====================================================================
C:\BBS\DFILES <---- Your "Main Data File Path".
C:\MULTI <---- Your "Multi-user Data File Path".
C:\BBS\FPOINTS.LOG <---- Path and File Name for the LOG.
1F/5U <---- File Points (0-255)F/User Points (0-65535)U
to assign to all uploaded files that are not
found within the Paths specified within the
following lines. Please insure that the "F",
"/" and "U" are placed as shown.
SIZE <---- Statement required if you are assigning File
Points by File Size (Kbytes).
1-5K/5F/10U <---- Minimum Kbytes (1-5000)-Maximum Kbytes
(1-5000)K/File Points (0-255)F/User Points
(0-65535)U. Please insure that the "K", "F",
"/"'s and "U" are placed as shown.
6-10K/0F/20U <---- Minimum Kbytes (1-5000)-Maximum Kbytes
(1-5000)K/File Points (0-255)F/User Points
(0-65535)U. Please insure that the "K", "F",
"/"'s and "U" are placed as shown.
Note: The above example would only be seven lines long in the actual
FPOINTS.CFG file. The only limit to the number of lines beyond
Line 5 of FPOINTS.CFG is the Kbytes Maximum range of 5000 (which
allows for a 5,120,000 Byte file). File sizes are rounded to the
next highest value evenly divisable by 1024 Bytes, therefore a
value less then 1 Kbyte will never occur.
An error will result if any of the first five lines are incorrect. Although
spaces are checked for by FPOINTS, it is recommended that none be placed
before, within or after any line in the FPOINTS.CFG file. In the above
example, a file uploaded that is 1-Kbyte, would fall within the range 1-5
Kbytes and would be credited with "5" File Points and the User with "10" File
Points. If a file were uploaded that is 15-KBytes, (Which is not defined
above), the File would be credited with "1" File Point and the User with "5"
File Points (the default on Line 2). A file that is 9-Kbytes, would fall
within the range 6-10 Kbytes and the File would be given no credit, but the
User would receive "20" File Points. The main thing you should know is this:
If you don't setup the Kbytes ranges or the File/User Point Values correctly,
the File Points on Line 4 will be used an no errors will result!
"KBYTECVT" can be used to convert your existing File Base.
MISCELANEOUS INFORMATION:
=========================
When crediting the user with File Points, FPOINTS will not exceed the limit
of the "File Points Field" in the User Record (Limit is 65,535). Additionally,
FPOINTS will not exceed the limit of the "File Points Field" in the *.DIR
file (Limit is 255). FPOINTS has a number of "Error Messages" that are all
self-explanatory.
FPOINTS Version 3.0 by Dragon Software Page 4
==============================================================================
UPDATE HISTORY:
===============
Version 1.0
===========
- Released on 02 May 92 for T.A.G. Version 2.6.
Version 2.0
===========
- Released on 13 Jun 92 for T.A.G. Version 2.6c1.
- Removed the Clear Screen within FPOINTS.EXE so that the SysOp window is
not effected.
- FPOINTS.EXE will no longer write a file (COM0) to the drive when T.A.G. is
in LOCAL MODE.
- Added the ability for FPOINTS.EXE to recognize the "@" in front of the *.DIR
file name in the FBOARDS.DAT file (used to send *.DIR files to the Data
Files Directory) and the "`" in front of the *.DIR file name in the
FBOARDS.DAT file (used to send *.DIR files to the Multi-Node Path).
- Increased the allowable Point Value for the User Record from 32,767 to
65,535.
- Added the ability for FPOINTS.EXE to credit the File uploaded and User with
different Points.
- Added the ability for the SysOp to assign File Points by one of three
methods: Globally for all files uploaded, by file size (kbytes) or by
file upload path.
- Added a configuration editor (FPCONFIG.EXE) to create the three different
FPOINTS.CFG files.
- Fixed the problem with FPOINTS not finding "Batch Uploaded" files (Missed
this note in the 2.0 Release).
Version 3.0
===========
- Released on 23 Jul 92 for T.A.G. Version 2.6c1.
- Fixed a bug that was created when we added the ability for SysOps to use
one of three methods when assigning File Points. This bug prevented
checking to verify files were actually present in the Upload Directory
before assigning File Points in the "GLOBAL" mode of operation. The
"PATH" and "SIZE" modes were not effected by this bug!
- Added a log feature.
- Added a SIZE (Kbyte) Conversion Utility (KBYTECVT.EXE) that will convert
your entire File Base over to the Point Values you assign in the
FPOINTS.CFG file.
FPOINTS Version 3.0 by Dragon Software Page 5
==============================================================================
FUTURE UPDATES:
===============
Make FPOINTS "Share" and "Multi-node" aware. Possibly come up with a better
way to convert the file base over when using the "PATH" option, instead of
using DIRPNT the way it is currently designed.
THANKS:
=======
A special "THANKS" goes to the T.A.G. Team for all the work they have done on
T.A.G. and for the T.A.G. v2.6b Turbo Pascal Record Structures! Thanks also
goes to Wade Fallin, SysOp of Whispers BBS for his suggestion to write the
FPOINTS utility.
COMMENTS:
=========
If you have any suggestions or comments for this program, please
leave a message addressed to "NUCLEAR" or "MERCURY" on one of the
following BBS's:
Fantasy Island (804)486-0724 Fidonet 1:275/4
Whispers BBS (T.A.G. BETA) (904)744-5624 Fidonet 1:112/90
The Gathering (804)481-3090
Or send a letter to (In care of: Dragon Software):
Lee Palmer Rick Mercado
1660 Kepler Bend 8216 Edwin Drive
Virginia Beach, VA. 23454 Norfolk, Va. 23505
(804)426-7048 (804)588-7125
Or call Dragon Software BBS at (804)480-3909 Fidonet 1:275/78